home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / art&graf.ix / art-3485 / art-5110 / ximg1311 / img.txt < prev    next >
Text File  |  1995-07-06  |  6KB  |  156 lines
  1.  
  2.             Virtual screen XIMG viewer XIMGVIEW
  3.                            and
  4.               XIMG snapshot utility XIMGSNAP
  5.  
  6.                        1994, 1995
  7.  
  8.                           (C)
  9.  
  10.                      Eero Tamminen
  11.  
  12. XIMGVIEW
  13.  
  14. Viewer loads any IMG or XIMG picture and shows it. It's mainly intended
  15. for monochrome, but it should 'work' on any resolution. On monochrome it
  16. dithers color pictures. On color resolutions extra colors and bitplanes
  17. are just cut away (color quantization would be a hard thing to debug on
  18. a monochrome monitor that I have) so that images with more colors than
  19. the resolution supports won't look good at all (for more than 16 color
  20. pictures I recommend gif or jpeg encoded pictures as IMG format doesn't
  21. pack very efficiently).
  22.  
  23. Program should be compatible as all screen access is done with AES or
  24. VDI functions. I use no windows (therefore this program is on 'top' all
  25. the time it runs) as programming them is a bore and adds 'unnecessary'
  26. code ;-).
  27.  
  28. VIEWER USAGE
  29.  
  30. - Drop viewer icon onto the desktop (or install it for IMGs).
  31. - Drag image files on the viewer's icon and/or click on an IMG file.
  32. - If picture doesn't fit into screen, you can scroll it around by
  33.   moving the mouse.
  34. - By pressing a mouse button you'll get an alert box from which you
  35.   can select either previous or next picture or quit.
  36.  
  37. You could also just run the program as is. It will then give you a
  38. fileselector for selecting an IMG file to show.
  39.  
  40. XIMGSNAP
  41.  
  42. With the ximgsnap accessory you can save parts of the screen into a file
  43. as a standard GEM raster image (IMG). When run, the program will ask you
  44. which part of the screen you want to save: whole screen, top window
  45. workarea or the area that you'll define with a rubberband. After that
  46. the selected area is packed as a (X)IMG into a file. File will be saved
  47. into the folder pointed by CLIPBRD or SCRAPDIR enviroment variables or
  48. into C:\CLIPBRD, C:\ or A:\ (whatever will first meet the criteria)
  49. as SNAP_???.IMG.
  50.  
  51. This program doesn't need any additional memory during the packing, so
  52. it can be used also with the programs that grab all the remaining memory
  53. at the startup. Snapshot 'should' work on all 2-256 color resolutions.
  54. Maximum width for the saved area is 2000 pixels. Pictures are converted,
  55. packed and saved one line at the time. Ximg-snapshot works both as an
  56. acessory (might not be able to get the enviroment variables?) and an
  57. application.
  58.  
  59. DEVELOPEMENT
  60.  
  61. These programs are programmed in Everest text-editor 3.3e and compiled
  62. with Sozobon C v. 2.0X. Some debugging is done with GCC 2.5.8. I'm in
  63. need of betatesters (please send me e-mail feedback!) and the
  64. Compedium...
  65.  
  66. AIMS
  67.  
  68. Small program size and memory usage while still having a nice(?)
  69. user interface. I like things to be functional without too much
  70. frills :-).
  71.  
  72. TESTING ENVIROMENT
  73.  
  74. A STfm with 4MB ram, KaosTOS 1.4, a SM124 monochrome editor,
  75. MH-MiNT v1.12-h3 and Thing 0.31d desktop.
  76.  
  77. THANKS
  78.  
  79. - To Gryf aka Thomas Binder (binder@rbg.informatik.th-darmstadt.de)
  80.   for the IMG scanline packing code.
  81.  
  82. - To Warwick Allison for doing those wonderful GEM conforming games /
  83.   game ports (NetHack, AmiGo...). I recommend checking Warwick's GEM++
  84.   and AMS C++ libraries for GEM and game programming. I hope I would
  85.   have seen these before I wrote these programs, as these contain a
  86.   lot of interesting code...
  87.  
  88. - To Arno Weasel for the Thing desktop.
  89.  
  90. COPYRIGHT, DISCLAIMER AND DISTRIBUTION
  91.  
  92. Ximgview.prg and ximgsnap.acc are copyright of Eero Tamminen. XIMG
  93. scanline packing in snapshot.c is copyright of Thomas Binder.
  94.  
  95. These programs come with NO WARRANTY. Author cannot be held responsible
  96. for any damage done by proper or improper use of these programs.
  97.  
  98. These programs are freeware and can be distributed on condition that all
  99. the files ximgview.prg, ximgview.c, makeview.mak, ximgsnap.prg,
  100. ximgsnap.c, makesnap.mak and img.txt (this text) are included unchanged
  101. and there's *no* charge taken. Contact Eero Tamminen if you want to
  102. include any of these files with another program or onto a coverdisk.
  103.  
  104. You may include parts of the code in other freeware programs providing
  105. that your program documentation credits my and Thomas' efforts.
  106.  
  107.         Eero Tamminen
  108.         t150315@cc.tut.fi
  109.         puujalka@modeemi.cs.tut.fi
  110.  
  111.         23600 Kalanti
  112.         Finland
  113.  
  114.     Thomas Binder
  115.     binder@rbg.informatik.th-darmstadt.de
  116.  
  117.     Johann-Valentin-May-Straße 7
  118.     64665 Alsbach-Hähnlein
  119.     Germany
  120.  
  121. CHANGES
  122.  
  123. 05.09.1994, Viewer v1.0.
  124.  
  125. 12.09.1994, Viewer v1.1. Added dialogs for showing what viewer does.
  126.  
  127. 14.09.1994, 30% speed up in dithering.
  128.  
  129. 10.11.1994, Viewer v1.2. Added color changing, screen redraw after
  130. showing an image and removed my own interleave routine from the viewer.
  131.  
  132. 13.11.1994, Viewer color resolution picture conversion routine now does
  133. conversion a line by line, thus needing upto 30% less memory than
  134. before.
  135.  
  136. 05.12.1994, Removed help from the viewer and added fileselector for use
  137. with the old desktops.
  138.  
  139. 28.11.1994, Snapshot v0.8.
  140.  
  141. 03.11.1994, Snapshot v1.0. Included Gryf's img scanline packing code.
  142.  
  143. 05.12.1994, Removed fileselector from the snapshot as most fileselectors
  144. don't clean up the screen and doing the redraw myself (would need a
  145. screen sized backup buffer) or using events to give main application(s)
  146. time to do the redraw) would be impractical.
  147.  
  148. 18.3.1995, Viewer 1.3 & snapshot 1.1. Added a color palette order
  149. conversion (palette saved before in VDI order, which doesn't correlate
  150. with h/w color order (A real bummer I say)). Snapshot will now save
  151. images to CLIPBOARD folder if possible. Viewer has now an alert box
  152. for image info and for loading the previous / next picture.
  153.  
  154. 6.5.1995, snapshot 1.12. Fixed a bug in the saving path code and
  155. applied Thomas' patches to the source (eg. MagiC work-around).
  156.